Add linux compatibility articles #129
Open
+81
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Added section and overview page
Deploying wiki with
|
| Latest commit: |
b701420
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://acbcb545.wiki-5tv.pages.dev |
| Branch Preview URL: | https://linux-usage.wiki-5tv.pages.dev |
JJL772
reviewed
Jan 18, 2026
Member
|
You should also add an entry to that table for the engine tools (particle editor, material editor, etc.), since those are natively supported. |
Included more info on running under wine, and also expanded page to include HLMV and Faceposer
ENDERZOMBI102
requested changes
Jan 24, 2026
Added row about ps1 scripts, removed a bunch of useless spaces, restructured note on tools page
Maybe shouldnt be writing wiki articles whilst sleep deprived and while burnt out from school
JJL772
approved these changes
Jan 24, 2026
| | vbsp/vvis/vrad | Native | Only for use in shell scripts/wrappers. When running Hammer under Wine, make sure to point to the Win64 versions for compatibility. | | ||
| | `.ps1` scripts | Native | Requires [Powershell](https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell-on-linux?view=powershell-7.5) to be installed. | | ||
| | All engine tools (particle editor, material editor, etc)| Native | None | | ||
| | SDK launcher | Native | Must use version in `Portal 2 Community Edition/bin/linux64`, launching from Steam will launch the .exe version. | |
Member
There was a problem hiding this comment.
is this actually the case? ref'ing craftable's comment seems like not, but I'm unable to test it
| This process uses [Wine](https://www.winehq.org/), a program which acts as a translation layer that converts Windows calls into Linux calls, without the need for emulation. Wine can be installed using your distro's appropriate package manager, typically under the package name `wine`, or from Wine's website. | ||
|
|
||
| >[!CAUTION] | ||
| >Since Wine 11, both the 32 and 64 bit packages of wine have been combined into one, so you only need to install the `wine` package for the tools to run properly. Installing the seperate outdated 32 and 64 bit packages is not recommended and will likely cause issues. |
Member
There was a problem hiding this comment.
This assumes the user is running either Debian or a derivative, on other distros (Fedora, Arch, Alpine) this is not the case.
| If using a Virtual Machine or emulator such as WinBoat, the tools should work as-is, apart from any configuration file changes. | ||
|
|
||
| ## Running Windows Tools | ||
| This section uses Hammer as an example, but applies also to HLMV and Faceposer. Just replace all instaces of `hammer.exe` with the appropriate executable. |
Member
There was a problem hiding this comment.
typo, should be instances
|
|
||
| ### Creating a Shell script | ||
| For ease of use, you may find it useful to create a Shell (`.sh`) script that automatically runs Hammer under Wine. Here is an example of a script for Portal 2: Community Edition named `hammer.sh` located in `/bin/linux64/`: | ||
| ``` |
Member
There was a problem hiding this comment.
the shebang (#!/usr/bin/env sh) is missing here
|
|
||
| For HLMV/Faceposer or if you only have one config for Hammer, first try making sure that the path specified in your `-game` option exists and that a `gameinfo.txt` file exsits. If it does exist but `gameinfo.txt` still cannot be found, try using an absolute path. This should fix most cases of broken paths. If this does not fix your issue, navigate to `<game>/hammer/cfg` and either delete or rename `gameconfig.txt`. This will recreate your game configuration file next time you start Hammer, and will likely fix all issues with broken paths. Alternatively, you can manually edit the file to alter the paths to their correct location. | ||
| >[!NOTE] | ||
| >Wine prefixes all paths with a fake drive letter, `Z:` by default, to maintiain compatibility with Windows filesystems. Make sure to add this to the beginning of all your paths for them to work correctly. |
Member
There was a problem hiding this comment.
Each loaded partition has its own Wine drive, Z: is usually the root one.
ENDERZOMBI102
requested changes
Jan 24, 2026
Member
ENDERZOMBI102
left a comment
ENDERZOMBI102
left a comment
There was a problem hiding this comment.
mostly for the typos, almost everything else is a nitpick
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Adds a section to Modding that gives more info about Linux compat and how to make tools work thru Wine.
Still a WIP